云数据库GaussDB—API参考

云数据库GaussDB—API参考

  • 概述

    GaussDB是华为自主创新研发的分布式关系型数据库。该产品支持分布式事务,同城跨AZ部署,数据0丢失,支持1000+的扩展能力,PB级海量存储。同时拥有云上高可用,高可靠,高安全,弹性伸缩,一键部署,快速备份恢复,监控告警等关键能力,能为企业提供功能全面,稳定可靠,扩展性强,性能优越的企业级数据库服务。

    您可以使用本文档提供API对数据库实例进行相关操作,如创建、删除、查询参数配置、扩容等。

    在调用GaussDB API之前,请确保已经充分了解GaussDB相关概念。

  • 调用说明

    GaussDB提供了REST(Representational State Transfer)风格API,支持您通过HTTPS请求调用。

  • 终端节点

    终端节点(Endpoint)即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询GaussDB的终端节点。

  • 基本概念
    1. 帐号
    2. 用户注册时的帐号,帐号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于帐号是付费主体,为了确保帐号安全,建议您不要直接使用帐号进行日常管理工作,而是创建用户并使用创建的用户进行日常管理工作。
    3. 用户
    4. 用户是云服务的使用人员,具有身份凭证(密码和访问密钥)。
    5. 我的凭证下,您可以查看帐号ID和用户ID。您需要用到帐号、用户和密码等信息。
    6. 区域
    7. 指云资源所在的物理位置,同一区域内可用区间内网互通,不同区域间内网不互通。通过在不同地区创建云资源,可以将应用程序设计的更接近特定客户的要求,或满足不同地区的法律或其他要求。
    8. 可用区
    9. 一个可用区是一个或多个物理数据中心的集合,有独立的风火水电,AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连,以满足用户跨AZ构建高可用性系统的需求。
    10. 项目
    11. 区域默认对应一个项目,这个项目由系统预置,用来隔离物理区域间的资源(计算资源、存储资源和网络资源),以默认项目为单位进行授权,用户可以访问您帐号中该区域的所有资源。如果您希望进行更加精细的权限控制,可以在区域默认的项目中创建子项目,并在子项目中购买资源,然后以子项目为单位进行授权,使得用户仅能访问特定子项目中资源,使得资源的权限控制更加精确。

云数据库GaussDB部分功能展示

  • GaussDB重置管理员密码

    在使用云数据库GaussDB过程中,如果忘记数据库root帐号密码,可以重新设置密码。

    在使用云数据库GaussDB过程中,如果忘记数据库root帐号密码,可以重新设置密码。

  • GaussDB实例绑定和解绑弹性公网IP

    GaussDB实例创建成功后,支持用户绑定弹性公网IP,在公共网络来访问数据库实例,绑定后也可根据需要解绑。

    GaussDB实例创建成功后,支持用户绑定弹性公网IP,在公共网络来访问数据库实例,绑定后也可根据需要解绑。

  • GaussDB规格变更

    随着业务的不断增加,实例的CPU和内存资源可成会为实例性能的瓶颈,无法满足业务要求时,GaussDB提供了规格变更功能来提升实例的CPU和内存。

    随着业务的不断增加,实例的CPU和内存资源可成会为实例性能的瓶颈,无法满足业务要求时,GaussDB提供了规格变更功能来提升实例的CPU和内存。

  • GaussDB变更副本数量

    GaussDB提供了将分片中的三副本降低为两副本功能,从原先的1主2备,降低为1主1备。其他类型的节点,例如CN,CMS/ETCD,GTM的副本数保持不变。

    GaussDB提供了将分片中的三副本降低为两副本功能,从原先的1主2备,降低为1主1备。其他类型的节点,例如CN,CMS/ETCD,GTM的副本数保持不变。

  • GaussDB比较参数模板

    可以将云数据库GaussDB当前实例应用的参数与参数模板进行比较,以了解当前实例参数的差异项。

    可以将当前云数据库GaussDB实例应用的参数与参数模板进行比较,以了解当前实例参数的差异项。

  • GaussDB复制参数模板

    当已创建一个数据库参数模板,并且想在新的数据库参数模板中包含该组中的大部分自定义参数和值时,复制参数模板是一个方便的解决方案。

    当已创建一个数据库参数模板,并且想在新的数据库参数模板中包含该组中的大部分自定义参数和值时,复制参数模板是一个方便的解决方案。

  • GaussDB重置参数模板

    您可根据自己的业务需求,重置自己创建的参数模板对应的所有参数,使其恢复到默认值。

    您可根据自己的业务需求,重置自己创建的参数模板对应的所有参数,使其恢复到默认值。

  • GaussDB导出参数

    可以将该实例对应的参数模板信息(参数名称,值,描述)导出到CSV中,方便查看并分析。

    可以将该实例对应的参数模板信息(参数名称,值,描述)导出到CSV中,方便查看并分析。

云数据库GaussDB培训赋能

连接云数据库GaussDB的方式

通过客户端和驱动都可以连接到数据库,GaussDB数据库提供DAS和gsql连接工具

  • 客户端连接

    云数据库GaussDB提供使用内网、公网和数据管理服务(Data Admin Service,简称DAS)的连接方式。

  • DAS连接

    通过华为云数据管理服务(Data Admin Service,简称DAS)这款可视化的专业数据库管理工具,可获得执行SQL、高级数据库管理、智能化运维等功能,做到易用、安全、智能地管理数据库。GaussDB默认开通DAS连接权限。

  • 内网连接

    当应用部署在弹性云服务器上,且该弹性云服务器与GaussDB实例处于同一区域,同一VPC时,建议单独使用内网IP连接弹性云服务器与GaussDB实例。

  • 公网连接

    不能通过内网IP地址访问GaussDB实例时,使用公网访问,建议单独绑定弹性公网IP连接弹性云服务器(或公网主机)与GaussDB实例。

  • 示例:使用DAS连接GaussDB并执行SQL

    创建最小规格的GaussDB按需计费实例,使用DAS连接数据库,并执行基本的SQL语法。